package com.xiaohua.system.service;

import java.util.List;
import com.xiaohua.system.domain.XhUsers;
import com.xiaohua.common.service.ITokenService;

/**
 * 用户管理Service接口
 * 
 * @author 小花
 * @date 2025-03-22
 */
public interface IXhUsersService extends ITokenService
{
    /**
     * 查询用户管理
     * 
     * @param userId 用户管理主键
     * @return 用户管理
     */
    public XhUsers selectXhUsersByUserId(Long userId);

    /**
     * 查询用户管理列表
     * 
     * @param xhUsers 用户管理
     * @return 用户管理集合
     */
    public List<XhUsers> selectXhUsersList(XhUsers xhUsers);

    /**
     * 新增用户管理
     * 
     * @param xhUsers 用户管理
     * @return 结果
     */
    public int insertXhUsers(XhUsers xhUsers);

    /**
     * 修改用户管理
     * 
     * @param xhUsers 用户管理
     * @return 结果
     */
    public int updateXhUsers(XhUsers xhUsers);

    /**
     * 批量删除用户管理
     * 
     * @param userIds 需要删除的用户管理主键集合
     * @return 结果
     */
    public int deleteXhUsersByUserIds(Long[] userIds);

    /**
     * 删除用户管理信息
     * 
     * @param userId 用户管理主键
     * @return 结果
     */
    public int deleteXhUsersByUserId(Long userId);
    
    /**
     * 用户名密码登录
     * 
     * @param username 用户名
     * @param password 密码
     * @return 用户信息
     */
    public XhUsers loginByUsername(String username, String password);
    
    /**
     * 检查用户tokens是否足够
     * 
     * @param userId 用户ID
     * @return 如果用户tokens足够返回true，否则返回false
     */
    public boolean checkUserTokens(Long userId);
    
    /**
     * 扣减用户tokens
     * 
     * @param userId 用户ID
     * @param amount 扣减的tokens数量，默认为1
     * @return 扣减成功返回true，否则返回false
     */
    public boolean deductUserTokens(Long userId, int amount);
    
    /**
     * 扣减用户tokens，默认扣减1个token
     * 
     * @param userId 用户ID
     * @return 扣减成功返回true，否则返回false
     */
    public boolean deductUserTokens(Long userId);
}
